home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / v56a2.zip / VFIDO.DOC < prev    next >
Text File  |  1993-01-14  |  16KB  |  390 lines
  1. VBBS / Fido Gateway Version 5.60.01
  2. ===================================
  3.  
  4. Copyright Neil J Marshall 14th January 1993
  5.     TransAtlanticBBS (+44-689-890937)
  6.         1 @ 440 VirtualNET
  7.         Neil J Marshall @ 2:440/211 Fido
  8.  
  9.  
  10. Contents
  11. ========
  12.  
  13. Introduction
  14. Initial Configuration Of VFIDO To Give E-Mail Functionality
  15. Configuration Of VFIDO To Add Conference Functionality
  16. Configuration Of VFIDO To Add Interface To FrontDoor
  17. Creation Of A Fido Network List For Use By VBBS
  18. Summary Of VFIDO Command Syntax
  19. Technical Information
  20. Development History
  21.  
  22.  
  23. Introduction
  24. ============
  25.  
  26. This program is designed to create an interface between the VBBS
  27. software written by Roland de Graaf and any Fido-compatible
  28. network. FidoNET itself is the largest hobbyist network in the
  29. world, with over 14,000 BBS as members, and there are literally
  30. thousands of smaller Fido-compatible networks worldwide.
  31.  
  32. This version of the interface program allows the exchange of
  33. private mail and public message areas between VBBS and Fido. It
  34. no longer requires the use of FrontDoor to handle the calls to and
  35. from other Fido BBS, although you can continue to use FrontDoor if
  36. you so desire.
  37.  
  38.  
  39. Initial Configuration Of VFIDO To Give E-Mail Functionality
  40. ===========================================================
  41.  
  42. Place the VFIDO.EXE program in your VBBS directory.
  43.  
  44. Run VCONFIG.EXE, and select Network Configuration for the Fido
  45. (type 4) network you are configuring.
  46.  
  47. 1. Fido Address:       2:440/211
  48.     Your Fido network primary address in Zone:Net/Node.Point format)
  49. 2. NetMail Directory:  C:\VBBS\NETMAIL
  50.     Where Fido netmail will be stored - must be the same for all your
  51.     Fido networks
  52. 3. OutBound Directory: C:\VBBS\OUTBOUND
  53.     Where Fido EchoMail will be stored - must be the same for all your
  54.     Fido networks
  55. 4. Archiver:           PAK
  56.     Compression method for outgoing EchoMail - PAK, LHA, ZIP, ARJ
  57. 5. UnArchiver:         PAK
  58.     Compression method for incoming EchoMail - PAK, LHA, ZIP, ARJ
  59. 6. FIDO Front-End:     Standalone
  60.     Standalone or FrontDoor are only valid options at this stage
  61. 7. Server:             2:440/6
  62.     This line is redundant now so fill in any valid Fido address
  63. 8. Nodelist Name:      NODELIST
  64.     The name of the nodelist for the network
  65. 9: Zones:              1-7
  66.     The range of Zones that belong to that network (ie the Domain)
  67.  
  68. D. Dial List
  69.     1. System Address:         2:440/59
  70.         Fido address of node to call
  71.     2. Phone Number:           0689-824890
  72.         Full phone number to dial
  73.     3. Poll Priority:          Hold
  74.         Hold means never call, Priority is call as soon as mail is
  75.         waiting, once a day is the final option
  76.     4. Preferred Session Type: EMSI (FSC-0056) w/Zmodem (DSZ)
  77.         EMSI or TSYNCH handshaking selection
  78.     5. Session Password:       FRED
  79.         The password to use in the EMSI session with the other BBS,
  80.         which may be blank
  81.  
  82. R. Routing
  83.     1: 2:440/59 2:440/59
  84.         Fido address of server and routing mask including wildcards. The
  85.         routing logic works top to bottom through this list so you can't
  86.         add anything meaningful after the last line with the *:*/* on it.
  87.     2: 1:1/1 1:*/*
  88.     3: 2:440/6 *:*/*
  89.    A)dd Lines E)dit Lines D)elete Empty Lines Q)uit:
  90.  
  91. A. AKAs
  92.     1: 2:440/59.3
  93.         Alternative address for the board - must be same Zone
  94.     2: 2:440/0
  95.    A)dd Lines E)dit Lines D)elete Empty Lines Q)uit:
  96.  
  97.  
  98. You will also need set up a file containing phone prefix aliases
  99. called VFIDO.FON in your DATA subdirectory. This is used to ensure
  100. that the phone numbers listed in the nodelist are converted to a
  101. format that can be dialed from your BBS. This is used for removing
  102. your country code for national calls and area code for local calls.
  103. VFIDO needs the correct phone numbers listed so it can call any BBS
  104. in the nodelist when Crash Mail, File Attaches or File Requests are
  105. sent.
  106.  
  107. The format of this file is:
  108.  
  109. 010-     The prefix for dialing international phone numbers
  110. 44- 0-   The translation from your own country's international code
  111.          to the national call code
  112.  
  113. As an example, the above would convert an international phone number
  114. listed in the nodelist as 1-616-399-4818 to 010-1-616-399-4818, or a
  115. national number in the nodelist as 44-689-890937 to 0-689-890937.
  116.  
  117. Place the unarchived nodelist into the C:\VBBS\NETMAIL directory and
  118. run:
  119.  
  120. VFIDO /C NETWORKID=#
  121.  
  122. then
  123.  
  124. VFIDO /A NETWORKID=#
  125.  
  126. And you are ready to roll.
  127.  
  128.  
  129. Sending E-Mail Using VFIDO
  130. ==========================
  131.  
  132. To send an E-Mail message from VBBS to any Fido-type network, invoke
  133. the E-Mail routine as normal. The User Network Address field should be
  134. completed in the format User Name@Fido Address, so to send E-Mail to me
  135. use Neil J Marshall@2:440/211.
  136.  
  137. If you want to send Crash Mail, that is where the E-Mail is sent
  138. directly to the addressee's BBS, ignoring the routing logic, then
  139. add a " /c" after the addressee's name, so to send Crash Mail to me use
  140. Neil J Marshall /c@2:440/211.
  141.  
  142. In Fido-type networks it is policy that messages with files attached
  143. must go directly to the addressee's BBS and ignore the routing logic,
  144. so if you attach a file to a message it will be held on your board
  145. awaiting a call from the addressee's BBS unless you send it Crash Mail
  146. or the addressee is one of the BBSs in your dialing list that you call.
  147.  
  148.  
  149. File Requests Using VFIDO
  150. =========================
  151.  
  152. If you want to send a File Request to another Fido-type BBS invoke the
  153. e-mail routine as normal. The User Network Address field should be
  154. completed in the format Sysop /f@Fido Address, where the " /f" is the
  155. switch to indicate this is a File Request. The Filename requested is
  156. put in the Title field of the message. All File Requests are sent direct
  157. to the addressee's BBS and ignore routing. If the addressee's BBS is not
  158. one that you have set up in your dialing list, then you must also use
  159. the /c switch to make the File Request a Crash E-Mail. To request the
  160. latest version of VFIDO from me, you would invoke the E-Mail function
  161. and address it to Sysop /f /c@2:440/211, then make the Title of the
  162. message VFIDO.
  163.  
  164. VFIDO also supports incoming File Requests. When a File Request is
  165. received, VFIDO searches each of the File Areas that you have set up in
  166. VCONFIG and sends the file back if it is found. VFIDO also supports
  167. "Magic Names" for File Requests - this is where a pseudonym is
  168. associated with an actual file for ease of access by calling systems.
  169. Magic Names should be set up in the file VFIDO.MAG in your DATA
  170. directory. The format of this file is one entry per line, giving the
  171. "Magic Name" followed by the full path and filename of the file to
  172. associate with the Magic Name, for example
  173.     VBBS C:\VBBS\FILES\SYSOP\VBBS560.ZIP
  174.     FILES C:\VBBS\MASTLIST.TXT
  175.     VFIDO C:\VBBS\FILES\SYSOP\VFIDO560.ZIP
  176. might be some of the most common ones.
  177.  
  178. If you want a "standard letter" sent in response to each file request,
  179. create this letter in a file called FILEREQ.TXT in your TEXT path.
  180. Generally a Fido Sysop should use this to list the Magic Names
  181. applicable to their BBS.
  182.  
  183.  
  184. Configuration Of VFIDO To Add Conference Functionality
  185. ======================================================
  186.  
  187. If you want to access public message areas in Fido, you will
  188. need to know the AREA name that uniquely identifies each Fido
  189. conference. Supposing for example you wished to set up VBBS to
  190. participate in a Fido conference whose AREA name was HARPOON:
  191.  
  192. Run VCONFIG.EXE and select Database Configuration, Message Bases,
  193. the relevant Group and Database. Then select Networks Configuration,
  194. A for add, select the network, and on the line for the Network
  195. Conference Identifier, put the AREA name of the Echomail conference
  196. in the network, and ALSO, separated by a space, the Fido addresses of
  197. the nodes to whom you directly circulate the conference, if you are
  198. acting as a local hub. You are currently limited to 80 characters here
  199. so you can't become a major hub yet. The line will look like this:
  200.  
  201. Network Conference Identifier: HARPOON 2:440/59 1:2/3
  202.                                ^       ^
  203.                                *       *
  204.                                *       *
  205.                                *  These are the Fido addresses of
  206.                                *  the next BBS in the conference's
  207.                                *  circulation list
  208.                                *
  209.                    This is the AREA name of the Fido
  210.                    conference
  211.  
  212. With these simple steps taken, every message posted on that
  213. conference will be echoed to Fido, and every message from Fido
  214. on that conference will be fed into VBBS.
  215.  
  216.  
  217. Using AreaFix To Request Conferences
  218. ====================================
  219.  
  220. You can add or remove your BBS to the subscription list for conferences
  221. on other Fido BBS using AreaFix.
  222.  
  223. All you have to do is to send a NetMail to AreaFix at the BBS address
  224. with your AreaFix password as the title (the AreaFix password is agreed
  225. in advance by yourself and the other Sysop) and a content that lists,
  226. line by line, the Area name of a conference, preceded by a - for remove.
  227.  
  228. For example, a message whose content read:
  229.  
  230. VFIDO_SUPPORT
  231. -GAMES_DISCUSSION
  232.  
  233. would add your BBS to the VFIDO_SUPPORT conference and remove it from
  234. the GAMES_DISCUSSION conference.
  235.  
  236. VFIDO supports incoming AreaFix requests as well. However, there is no
  237. facility for implementing an AreaFix password, so the title of the
  238. NetMail can be anything. 
  239.  
  240.  
  241. Summary Of VFIDO Command Syntax
  242. ===============================
  243.  
  244. VFIDO {channel number} {option} NETWORKID=#
  245.  
  246. # is the network identifier as specified in the NET.0 file for
  247. the network you are connecting to.
  248.  
  249. {channel number} is only necessary with /DIAL, /HOST and /POLL options.
  250.  
  251. {option} is one of:
  252.  
  253. /A      Build network list from nodelist
  254. /C      Compile initial Fido information
  255. /DIAL   Make a call to another Fido address, specifying the address
  256.         right after the switch like /DIAL2:440/211
  257. /HOST   Answer an incoming Fido call
  258. /POLL   Call all systems for whom Crash Mail is pending
  259. /U      Scan VBBS mail and toss to Fido
  260. /T      Scan Fido mail and toss to VBBS
  261.  
  262.  
  263. Technical Information
  264. =====================
  265.  
  266. VFIDO creates FTS-0001 packets for NetMail with FSC-0039 extensions for
  267. Zone and Point 4D addressing, FTS-0004 ARCmail packetsfor EchoMail,
  268. and FTS-0006 WaZOO-format File Requests.
  269.  
  270. Connections can be using FTS-0001 (TSynch) using XMODEM or
  271. FSC-0056 (EMSI) using ZModem.
  272.  
  273. Outgoing Crash Mail is only supported using EMSI.
  274.  
  275.  
  276. Release Notes
  277. =============
  278.  
  279. 5.60.01 Modified the /POLL routine to only poll within the
  280.         specified NETWORKID
  281. 5.60.01 Added display of EchoMail From Address during tossing
  282.         to assist correct configuration of EchoMail processor.
  283. 5.60.01 Corrected TSYNCH handshake to cope with empty incoming
  284.         packets
  285. 5.60.01 Corrected the AreaFix message format to follow the Fido
  286.         standard for add requests
  287. 5.60.01 Modified the initial handshake after CONNECT to support
  288.         mailers that generate a single Escape character
  289. 5.60.01 Added code to mask out REPLY lines reading 0:0/0
  290. 5.60.01 Added code to mask out invalid MSGID lines from Xenolink
  291. 5.60.01 Added support for Session Passwords
  292. 5.60.01 Updated processing of Origin information in EchoMail to
  293.         handle invalid formats of the Origin without crashing
  294. 5.60.01 Corrected incoming EchoMail processing logic to handle mail
  295.         from multiple networks simultaneously
  296. 5.60.01 Takes phone off hook during mail tossing
  297. 5.60.01 Modified call to DSZ to handle duplicate incoming file names
  298. 5.60.01 Added abort by spacebar in dialouts
  299. 5.60.01 Added pause between redials
  300. 5.60.01 Corrected processing of nodelists with sub-100 extensions
  301. 5.60.01 Added Carrier Detect functions to detect loss of connection
  302.         in incoming and outgoing calls
  303.  
  304. 5.60.00 Added incoming AreaFix functionality
  305. 5.60.00 Added incoming & outgoing Crash Mail functionality
  306. 5.60.00 Added incoming & outgoing File Attach functionality
  307. 5.60.00 Added incoming & outgoing File Request functionality
  308. 5.60.00 Integrated the FrontDoor telephone handling functionality
  309. 5.60.00 Introduced support for Domains
  310. 5.60.00 Upgraded routing to give unlimited routing flexibility
  311. 5.60.00 Introduced support for Aliases
  312. 5.60.00 Introduced support for simultaneous multiple Fido-type networks
  313. 5.60.00 Reintroduced the PATH statement in EchoMail
  314. 5.60.00 Introduced support for unarchived EchoMail
  315. 5.60.00 Improved the detection of origin information on incoming EchoMail
  316. 5.60.00 Added processing to correct Private EchoMail and Public Netmail
  317. 5.60.00 Added support for To: field in EchoMail
  318. 5.60.00 Upgraded to support VBBS 5.60
  319.  
  320. 5.52.04 Corrected the problem that was preventing messages from Fido being
  321.         gated out to VirtualNET clients and servers
  322. 5.52.04 Improved the detail provided on-screen as messages are being
  323.         processed (to give you something to read as the program chugs
  324.         slowly along!)
  325. 5.52.04 Cured the problem of VFIDO "reflecting" EchoMail back to the
  326.         original sender thereby causing duplicates
  327. 5.52.04 Corrected the display of the From address for incoming EchoMail so
  328.         that it no longer always shows the Server's address
  329. 5.52.04 Removes the AREA and SEEN-BY lines from incoming EchoMail before
  330.         posting it to VBBS
  331. 5.52.04 Introduced an automatic word-wrap on incoming messages to cater for
  332.         those annoying Fido mailers that fail to word-wrap their messages as
  333.         they are entered
  334.  
  335. 5.52.03 Corrected another bug in the usa of LHA for archiving
  336.  
  337. 5.52.02 Corrected a bug that was making the VBBS mail tosser skip messages
  338.  
  339. 5.52.01 Corrected the use of LHA as an archiving and unarchiving protocol
  340.         since it was making VFIDO crash
  341.  
  342. 5.52.00 Completely rewrote echomail handling for multiple clients (the
  343.         last version was my first attempt and was not too good!)
  344. 5.52.00 Added recognition of soft carriage returns in message text
  345. 5.52.00 Corrected SEEN-BY line on echomail to show NET/NODE only
  346. 5.52.00 Forced e-mail to use real name
  347. 5.52.00 Corrected FLAGS for file-attached archived message packets
  348. 5.52.00 Corrected expected name of NODELIST files
  349. 5.52.00 Added a VFIDO.LOG file that records file access attempts to help
  350.         debug obscure file problems
  351.  
  352. 5.51.00 Added support for VBBS 5.51
  353.  
  354. 5.50.06 Added support for multiple servers and multiple EchoMail clients
  355.         (this was a MAJOR job, let me tell you!)
  356. 5.50.06 Corrected bug causing crashes if subdirectories under NETMAIL
  357. 5.50.06 Fixed crash caused by blank lines in NET.0
  358. 5.50.06 Fixed crash caused by archived NODELIST in VFIDO /A
  359.  
  360. 5.50.05 Fixed ARCmail file attach message bug
  361. 5.50.05 Fixed INTL addressing bug
  362.  
  363. 5.50.04 Fixed horrendous bug in the 5.50.03 EchoMail processor
  364.  
  365. 5.50.03 Rewrite of mail processor to handle large messages
  366.  
  367. 5.50.02 Fido mail addressed to SysOp is routed to #1 account
  368. 5.50.02 Origin line now has only 1 leading space
  369. 5.50.02 SEEN-BY and PATH now in correct order on Conference mail
  370.  
  371. 5.50.01 Failure to toss Fido Conference mail to VBBS message areas
  372.  
  373. 2.2     Fixed bug in showing Fido node in VBBS
  374.  
  375. 2.1     Fixed bug in Fido echomail to VBBS conversion
  376.  
  377. 2.0     First Public Release
  378.  
  379. 1.5     Beta
  380.  
  381. 1.4     Beta
  382.  
  383. 1.3     Beta
  384.  
  385. 1.2     Beta
  386.  
  387. 1.1     Beta
  388.  
  389. 1.0     Beta
  390.